/*
 * Copyright (c) 2011, salesforce.com, inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, are permitted provided
 * that the following conditions are met:
 *
 *    Redistributions of source code must retain the above copyright notice, this list of conditions and the
 *    following disclaimer.
 *
 *    Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
 *    the following disclaimer in the documentation and/or other materials provided with the distribution.
 *
 *    Neither the name of salesforce.com, inc. nor the names of its contributors may be used to endorse or
 *    promote products derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
 * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */
package com.sforce.rest;

import java.io.IOException;

import com.sforce.rest.pojo.SObject;

/**
 * 
 * @author gwester
 * @since 172
 */
public interface RestConnection {

	public DescribeGlobal describeGlobal() throws IOException, RestApiException;
	
	public DescribeSobject describeSobject(String sobjectName) throws IOException, RestApiException;
	
	public DescribeLayout describeLayout(String sobjectName) throws IOException, RestApiException;
	
	public SObjectResult create(SObject sobject) throws IOException, RestApiException;
	
	public SObjectResult update(SObject sobject, String id) throws IOException, RestApiException;
	
	public SObjectResult delete(Class<? extends SObject> clazz, String id) throws IOException, RestApiException;
	
	public <T extends SObject> T get(Class<T> clazz, String id) throws IOException, RestApiException;
	
	public QueryResult query(String query) throws IOException, RestApiException;
	
	public SearchResult search(String search) throws IOException, RestApiException;
	
	public SearchResult recent() throws IOException, RestApiException;
}
